Software 2000

home *** CD-ROM | disk | FTP | other *** search

/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u601.dms / in.adf / ABackup / ABackup.doc < prev next >

Wrap

Text File | 1993-08-06 | 45.7 KB | 946 lines

ABackup - User's Manual AboutThisDoc This manual describes release 2.41 of the utility ABackup. This program is (c)1992-1993 by Denis GOUNELLE, any commercial usage or selling without author's written authorization is strictly forbidden. You can copy and spread this program at the following conditions: - all the files must be provided - none of the file must have been modified - you don't charge more than $6 for copy fee In spite of several tests, no warranty is made that there's no error in ABackup. YOU USE THIS PROGRAM AT YOUR OWN RISKS. In no event will I be liable for any damage, direct or indirect, resulting of the use of ABackup. Introduction ABackup is a backup program written for the Amiga. It can be used both to make a backup of your hard disk or to archive files, has a full Intuition interface, and can use XPK library. Under 2.0 system release, ABackup is able to recognize links and to manage high density disks. This program is SHAREWARE. If you find it useful, I invite you to send me $10 at the address listed below in order to become a registered user. Please use only : - checks from a French bank - cash (French Francs prefered, otherwise any currency of the E.E.C. is accepted, as well as US dollars and Swiss Francs ; in either case please add a little more for change fee) - checks from an European bank (if you use an EuroCheck, please add $5 because my bank taxes it) If you send me a check, it must be in French Francs and the beneficiary must be "M. GOUNELLE Denis". As a registered user, you will receive the next version of ABackup as soon as it will be available. You should be aware that this $10 contribution fee only gives right to one update : if you want to receive the next updates regularly, a $20 contribution is required. Suggestions and/or criticisms will be always welcomed. Don't hesitate to write at the following address : M. GOUNELLE Denis Boite 71 6, rue des cailloux 92110 CLICHY - FRANCE You can also send a message to the following Internet address : "gounelle@alphanet.ch". Note that this mailbox is not mine, so please send only short messages. As I don't have direct access to the messages, don't expect an answer before a dozen of days. Thanks to Michel SCHINZ (without him, this program would be still only at the planning stage) and Jean-Yves PROUX for their suggestions, to Reza ELGHAZI and Stefan SALEWSKI for their help concerning the crash under system 3.0. Special thanks to Jean-Philippe RAPP for his numerous suggestions and constant supporting. Last, thanks to XPK library authors for their fantastic work. Getting_started ABackup can be run as well from CLI as from Workbench. From the CLI, you can invoke ABackup by a syntax as follows : ABackup [FROM directory] [BUFSIZE size] [NOCOMP ext,ext,...] [NOTASK] [TMPDIR dir] [SIZE {BYTE|KBYTE|MBYTE|AUTO}] The BUFSIZE option allows to change the size of the read buffer (for example "BUFSIZE 64" asks for a 64 Kb buffer). By default, the buffer size is 4 Kb large. You can specify a directory name for backup (with the "FROM" option); by default, this one will be the current directory. The NOCOMP option allows to specify extensions of file names to don't compress. You can specify up to 10 extensions, separated by a comma (e.g.: "NOCOMP .info,.run"). Usually, ABackup tries to create a child task that will perform all write operations (this speedup backup between 10-20%). If the task creation fails, ABackup will do write operations itself, just like the previous versions of the program. If the creation of the child task is a problem (no memory etc...) you can prevent ABackup to create it with the "NOTASK" argument. The "TMPDIR" argument allows you to change the temporary directory used by ABackup. By default, it uses the "T:" directory, but this may cause lead to memory problems, especially if this directory is assigned to "RAM:T". The "SIZE" argument allows you to change the default unit of the "Size" menu (see below). The "USEASL" argument allows you to use the file requester of "asl.library" instead of the built-in requester. This option will be ignored if the library can't be opened, or if the requester can't be allocated. From the Workbench, you can change the size of the read buffer by adding a line of the form "BUFSIZE=<size in Kb>" in the "TOOL TYPES" field of ABackup icon. You can also specify extensions of file names to don't compress by adding a line of the form "NOCOMP=ext,ext,...", or prevent ABackup to create a child task by adding a line "NOTASK". Finaly, you can set ABackup as "DEFAULT TOOL" of an archive file. When the program starts, a screen is displayed with several gadgets in it : "Backup an AmigaDOS partition", "Restore", "Rebuild catalogue", and "Quit". Click on the gadget that matches the wanted action. The startup screen has also a menu with the "Config...", "About..." and "Quit" options. The first one allows to modify ABackup configuration (see "Configuration" section), the second one displays informations about the program, and the last one allows to quit ABackup. Configuration A window appears in the middle of the screen, with eight gadgets. The first three gadgets show the names of the viewer programs corresponding to the type of a file (ASCII file, IFF picture or other, see the "Viewing" section), the two next the names of the external compression/decompression program (see the "Compression" section), and the last the name of the temporary directory (see the "Getting_started" section). At the bottom of the window, three gadgets enable to validate the changes, to validate and save the changes, or to cancel the changes. The configuration is saved to the "S:ABackup.config" file, which is loaded each time the program start. Requesters When using ABackup, often you'll see requesters with one message and one or two gadgets ("Ok", "Continue/Abort", "Yes/No"). In any case, you can reply to a request by clicking on one of these gadgets, or by pressing the key corresponding to the first letter of a reply (for example, the "c" or "C" key for "Continue"). You can also press <RETURN> for a positive reply ("Ok", "Continue", "Yes") or <ESC> for a negative reply ("Abort", "No"). Finally, when a requester message asks for inserting a disk in one drive, inserting a disk in this drive will be detected and this will be equivalent to clicking on the "Continue" gadget. Backup_an_AmigaDOS_partition A requester is displayed that allows to choose the directory to backup. By clicking on the "Cancel" gadget, ABackup will return to the main screen. By clicking on the "OK" gadget, ABackup will load the directory contents. For breaking this loading, click on the "Abort" gadget or press one of the following keys : "a", "A", <ESC>. If you don't want ABackup to explore a sub-directory (for example a directory where's a program that you already have on floppy disk, and so you don't need to backup), just put the word "SKIPME" as the comment for this sub-directory. ABackup can now save several partitions in the same archive, so you don't have to save them one by one. To select the partitions to save, you can use the multi-selection of the file requester : click on the partition names (like DH0: and DH1:) holding the SHIFT key down. You can also call ABackup with the FROM option, and specify the partition names separated by a comma (like "FROM DH0:,DH1:"). In this case, if you use the Intuition interface, you won't see the file requester when you will click on "Save an AmigaDOS partition". Once the directory content loaded, the selection screen will apear (see the "The_selection_screen" section below). Backup options are : Compress Tells what kind of compression will be done : none (NO), with the functions integrated to ABackup (Internal), with an external program (External) or with XPK library. For more informations, see "Compression" section. If you press the SHIFT key when you click upon this gadget, the values will cycle in reverse order. Verify Reread and compares every track after writing it. Meaningful only for backup to disks. Backup links Backup selected links. Meaningful only under 2.0 system release. An archive which contains links can of course be restored even under 1.3 system release (links will simply be not restored). Set archive bit Once backup is over, sets the archive bit (see the AmigaDOS command "Protect") of all files and subdirectories successfully backed up. Backup report Indicates if ABackup has to create a backup report. This one can be printed or written to a file. Backup to Selects an archive. If a given name is of the form "df?:" (e.g. df0:, df1:, etc....), ABackup will use the specified disk unit by writing on disks in a special format. In this case, you need not to format your backup disks. Otherwise, ABackup will create an archive file with the name you specified. Note ABackup has the capability of creating this file on any device that accepts the AmigaDOS "Seek" function. You can use several disk drives for backup : specify the names of the drives separated by a coma. For exemple, if you specify "df0:,df1:" ABackup will start with disk in df0:, then continue with the disk in df1:, go back to df0:, etc... The program will automatically (without requester) toggle from one drive to the next, if the disk in the new drive has been changed. For starting a backup, you have to select the "Start" item in "Backup" menu or the "START" gadget. If you asked for backup report to be written to a file, a requester will be brought up so that you can specify a name for this file. If you click over the "Abort" button in this requester, no report will be generated. At this time, a new screen is brought up with different infos on the backup progression. In the bottom area, the file names pass by, followed by an info on the current operation (compression, writing, etc....). The "Disk" gauge displays the filling percentage either of the current disk, or of the volume where is the archive file. If you asked for a disk backup, you can remove the last disk from your drive as soon as the "Archive closed" message will be displayed. If an error occurs (and if this is possible), ABackup will display a message to ask if you want to continue in spite of that. Obviously, ABackup will not make a backup for the file that maked problem. At the top and on the right of this screen there are two gadgets. The "* ABORT *" gadget allows to abort a backup. After it asked to confirm, ABackup returns to the selection screen. The "* PAUSE *" gadget allows to pause a backup for a while. Note that it can happens ABackup doesn't react immediatly when you click over one of these gadgets but, in all cases, your request will be registered before the next write operation in the archive. Once a backup ended (a message will inform you of that), ABackup returns to its main screen. Restore A menu is brought up allowing to specify the archive that must be used. If you click on the "Abort" gadget, ABackup will return to the main screen. The gadgets corresponding to your drives are automatically enabled or disabled according to your hardware configuration. If you click on one of these enabled gadgets, ABackup will ask you to insert the last disk in the backup set, for loading the catalogue. If you click on the "File" gadget, a requester will be brought up so that you specify your archive file. If you click on the "Abort" gadget, ABackup will return to the main screen. Once you have selected an archive, ABackup will load the catalogue of files backed up in this archive and will display the selection screen. Restore options are as follows : Restore dir. tree Indicates if selected files will be all restored in the same directory (NO) or if the tree structure will be restored too (YES). Restore date Indicates if ABackup will set the date of restored file to the date they had at backup time. Restore links Restore selected links. Meaningful only under 2.0 system release. Restoration report Indicates if ABackup has to generate a restoration report. This one can be printed or written to a file. Restore empty dirs Indicates if ABackup has to create empty backed up directories. Replace files Indicates what ABackup has to do if a file it has to restore already exists. Choices are : "No" (file is not replaced), "Yes" (file is replaced), "Ask for" (ABackup will ask to confirm for every existing file), "Older" (ABackup replaces this file only if this one is older than the backed up file). Restore from This option is available only when restoring from floppy disks. It allows to use several disk drives : specify the names of the drives separated by a coma. For exemple, if you specify "df0:,df1:" ABackup will start with disk in df0:, then continue with the disk in df1:, go back to df0:, etc... The program will automatically (without requester) toggle from one drive to the next, if the disk in the new drive has been changed and if this disk is the one which is expected by ABackup. Restore to Usually, files are restored in the directory where they were at the time of the backup, but you can specify another directory by this gadget. For starting a restoration, you have to select the "Start" item in "Restore" menu or the "START" gadget. If you asked for restoration report to be written to a file, a requester will be brought up so that you can specify a name for this file. If you click over the "Abort" button in this requester, no report will be generated. At this time, a new screen is brought up with different infos on the restore progression. In the bottom area, the names of restored files pass by, followed by an info on the current opération (reading, etc....). If an error occurs (and if this is possible), ABackup will display a message to ask if you want to continue in spite of that. Obviously, ABackup will not restore the file that maked problem. If some links are to be restored, ABackup will restore them after all other files and directories are restored. At the top and on the right of this screen there are two gadgets. The "* ABORT *" gadget allows to abort a restoration. After it asked to confirm, ABackup returns to the selection screen. The "* PAUSE *" gadget allows to pause restoration for a while. Note that it can happens ABackup doesn't react immediatly when you click over one of these gadgets but, in all cases, your request will be registered before the next read operation in the archive. Once a restoration ended (a message will inform you of that), ABackup returns to its main screen. Rebuild_catalogue This function is not very useful unless an archive file has been damaged, or you have loose the last disk of a backup set. It will rebuild the archive catalogue, which is required to restore. You should be aware that this function can't handle all errors, and may not be usuable by unexperienced users. If the archive is a file, you should make a copy of it in order to avoid to destroy it if operation fails. You will also have to check that the first header is at a sector boundary, that is, at an address multiple of 512 (you can use the "TYPE archive HEX" command, the first and the third long word of a header are always set to the "ABCK" value). If the archive is on disks, you must give the disks in the same order they were written to. This function works even if disks are missing. The archive selection screen appears (see "Restore" section). When you have selected the archive, ABackup loads its content, file after file : a new screen appears with some informations about the processing. Once the content is loaded, the new catalogue will be created. If the archive is on disks, ABackup will ask you for a new disk to write the catalogue. Use this disk a the last disk of the backup set, when restoring. The_selection_screen This screen consists of a gadgets set and a bottom area where are displayed files and subdirectories of the current directory. At the start, no file and no directory are selected. Files are displayed in black on grey background, and directories in white on grey. Directories with at least one descendant selected are displayed on a black background. You can scroll the list display by means of the vertical scroll bar on the right. The name of the current directory is displayed in the area named "Directory". The number and size of the selected files are displayed in the area named "Selection". For selecting a file in a list, click on the name of this file : it is displayed in black on a blue background and the "Selection" area is updated. If you click on a selected file, this one will be unselected. For selecting or unselecting a set of files, click on the first file and keep down the left button while moving your mouse. Last, to view a file, just double-click on its name (see "Viewing" section). When you click on a directory name, two actions can happen. If this directory is empty, it will be selected or unselected as a file. Otherwise, the list display will be modified in order to make visible the contents of this directory. The "Directory" area will be updated. To go back to the previous directory, you can either click on the "Parent" gadget (at the top of the scroll bar), either click on the gadget between the left border of the screen and the left border of the display area. If you went very down in the tree structure, you can go back straight at the initial directory by clicking on the "Root" gadget (at the top of the scroll bar). Last, if you hold the SHIFT key while you click upon a directory name, the whole directory content will be selected or deselected. At the top of the screen, there are two rows of identical gadgets. These ones allow to select (first row) or to unselect (second row) files and/or subdirectories in a global way according to various criterions : All Selects or unselects all files and subdirectories from the current directory. By name Selects or unselects files and subdirectories according to a name or a pattern. A pattern is a name with one of the special AmigaDOS characters: '#' or '?' under 1.3 system release, '#', '?', '|', '~', '%', parenthesis, or brackets under 2.0 system release. For more informations, refer to your AmigaDOS User's manual. A window is displayed with a string gadget. Type in it a name or a pattern and validate your choice by pressing <RETURN>. Now, click either on the "==" gadget, if you want files or subdirectories whose name matches the name or the pattern you typed, either on the "!=" gadget, if you want files or subdirectories whose name doesn't match the name or pattern you typed. You can cancel this operation by clicking on the window close gadget. By date Selects or unselects files and subdirectories according to the date of the last change. A window is brought up with a string gadget. Type in a date and/or time respecting the following syntax : DD-MM-YY or DD-MMM-YY for the date (for example, "01-03-92" or "01-Mar-92"), and HH:MM:SS for time. Validate your choice by pressing the <RETURN> key, then click over the "<=" gadget or the ">=" gagdet, according as you want to get earlier files and subdirectories or later ones in relation to the typed date. If you typed only time, the date will be the day date. If you typed only a date, time will be "23:59:59", when you click over "<=", or "00:00:00", when you click over ">=". You can cancel this operation by clicking on the window close gadget. By bits Selects or unselects files and subdirectories according to their protection bit. A window is brought up with a string gadget. For testing one or several bits (see the AmigaDOS command "Protect"), type them in this gadget and validate your choice by pressing the <RETURN> key. Click now over the "= 1" or "= 0" gadget according as you want files and subdirectories with their bits set or unset. You can cancel this operation by clicking on the window close gadget. The "Reverse" gadget allows to invert a selection : all selected files become unselected and all unselected files become selected. The "Recursive" gadget controls the action of the "Reverse" gadget, just as it controls the "All", "By name", "By date" and "By bits" gadgets : it shows if selecting or unselecting will or will not concern files that are in the subdirectories of the current directory. The selection screen has three menus too. The "Size" menu allows to change unit ABackup is using to display the size of selected files. You can choose beetween Bytes (the default unit), Kilobytes and Megabytes. If you select the "Automatic" item, ABackup will automatically change of unit, depending of the size of selected files. Later, we'll describe the "Selection" menu. Last, the first menu is either "Backup" or "Restore" (depending of which operation you've choosen) and has the following options : Start Allows to start backup or restore. If you selected no file and no subdirectory, an error message will be displayed. Options Allows to change the backup or restore options. Estimations Gives an estimation of backup time and of the number of disks needed. The result depends of the size of the selected files, of backup options, and of the processor inside your Amiga. It may not be accurate if other tasks are running during the backup. ABackup always suppose that you backup a hard disk to floppies. About... Displays some informations on this program. To continue, click within the window, over the window close gadget or press any key. Abort Allows to abort whole operation. After it asked to confirm, ABackup returns to the main screen. Error_recovering When an error occurs while writing on a disk, you will see the following message "Write error on DFx:, should I try to recover ?". If you answer "NO", the backup will be aborted. If you answer "YES", ABackup will copy all data already written on the bad disk to a new disk, so backup will be able to continue. So, you will have to provide a new disk, of the same type than the bad one : you can't use (for example) a High Density disk (1.76 Mb) to replace a normal density disk (880 Kb). The copy will be processed using a single disk drive. In order to limit disks swap, ABackup will allocate a buffer in memory. The size of this buffer will not be greater than half of the largest CHIP memory block still available, *OR* than the size of three tracks. If this buffer can't be allocated, the backup will be aborted. CAUTION : If you made an error recovering during a backup, I strongly advise you to verify the archive so you'll be sure that all went well. Viewing From the selection screen, you can view any file just by double-clicking on its name. A window appears, with several gadgets. The "Execute" gadget shows the name of the viewer to use for the selected file. The file's name and type (from which the name of the viewer is set) are displayed above (in white). You can, of course, modify the name of the program to use. The two lower gadgets allow you to start viewing ("OK" gadget), or to abort operation ("CANCEL" gadget). If you try to view a link, ABackup will just display the name of the file or directory the link points to. Compression ABackup is able to compress files to backup, in order to reduce archive size. By default, the algorithm is the same as for the "compress" UNIX command : you can hope for a space-saving from 30% to 50%, but the backup is seriously slowed down with a "normal" 68000 based Amiga. Note that ABackup will not try to compress files with a ".lha", ".lzh", ".zoo", ".arc", ".pp" or ".z" file name extension, as well as any file less than 512 bytes long. You can specify other extensions to don't compress, with the NOCOMP argument (see "Getting_started" section). ABackup also look at the first bytes of the files, to detect files already compressed by XPK or PowerPacker. You can use external compression and decompression programs, which may be faster and/or better. All you have to do is the modify ABackup configuration (see "Configuration" section) : enter the command to execute both for compression and decompression, specifying "%s" as a source file and "%d" as a destination file. For exemple, in order to use the commands provided with PowerPacker (copyright by Nico François), enter : Crunch %s %d NOLED NOPER NOSUFFIX EFFICIENCY 1 as compression program, and : Decrunch %s %d QUIET as decompression program. You won't be able to select external compression as long as no command name has been given. When backing up and restoring, ABackup automatically runs the specified commands, and redirect their output to the "T:ABackup.log" file. You can look at this file if an error occurs. This version of ABackup can also use the XPK library (on Fish disk 754). This library will be automatically recognized if already installed in your "LIBS:" directory. You will then be able to select one of the available compression method, in the options window. The name of the methods are prefixed with a "x" character, like "x BLZW". Take care that it won't be possible to restore an archive compressed with an external program, or with XPK library, if you don't have the corresponding decompression program. Though, you should avoid to use external compression if you plan to give the archive to somebody else. The_catalogue ABackup creates a catalogue of the files archived, and use it to restore. This catalogue is put at the end of the archive. If you loose the catalogue (archive file damaged or disk lost), you can create a new catalogue with the "Rebuild_catalogue" function, described below. This version of ABackup uses a new catalogue format, far more compact than the previous one : the catalogue is then two or three times smaller than before. The size of the catalogue is displayed when ABackup add it the the archive. Of course, this program can load a catalogue created by the older versions of ABackup, but the contrary is not true. With the old format, you could have memory problems with big archives (several thousands of files) because the catalogue will take a lot of memory. If you ever have a "not enough memory" error when loading a catalogue (whatever version of ABackup you use) here is two tricks to restore files anyway. The first solution is to reboot you Amiga, so you'll start with an unfragmented memory. If you mounted a "RAD:" disk, remove it with the "RemRAD" command before you reboot. If you have some background utilities you don't need while restoring, kill them to free more memory. Then, use the TMPDIR argument to assign the temporary directory to a hard disk partition with at least 1 Mb of free space, and try again to restore. If ABackup fails again, you will have to use the second method. The second solution is to create new catalogues, that will be smaller. If the archive has been created with an old version of ABackup, try first to make only one catalogue : as the new format is more compact, maybe this will be enough. Else, you will have to make several catalogues : divide your archive in several parts, and create a new catalogue for each part. The_Selection_menu ABackup has the capability of recording a file selection so that you can recall it later : this can be useful if you use frequently the same selections. These ones are kept as text files containing a set of commands : these files are in the "ABCK:" directory. In order to record a selection, choose the "Record" item in the "Selection" menu; then, do your selection as you do usually. Note that, during this recording, the "Backup" menu disappear (for the time being). Once you have ended, select the item "Save" in the "Selection" menu to save your selection. If you want to abort a recording, choose the item "Abort" in the "Selection" menu. To recall a selection, choose the "Load" item in the "Selection" menu. A file requester will be displayed allowing you to specify the selection file you want use. If you click on the "OK" gadget in this file requester, that file will be loaded and selection it contains will be executed. This is description of the selection language used by ABackup. This allows to create or modify a selection file as you like, by means of your usual text editor. CD : go back to root directory CD / go back to parent directory CD "dir" go down in given directory INVERT reverse selection RECURS {YES|NO} set recursivity flag INCLUDE ALL include all files INCLUDE "name" include given file INCLUDE NAME "name" {==|!=} select by name INCLUDE DATE "date" {<=|>=} select by date INCLUDE BITS "bits" {=0|=1} select by protection bits EXCLUDE ALL exclude all files EXCLUDE "name" exclude given file EXCLUDE NAME "name" {==|!=} exclude by name EXCLUDE DATE "date" {<=|>=} exclude by date EXCLUDE BITS "bits" {=0|=1} exclude by protection bits Here is an exemple of selection file: RECURS YES ; go back to root CD : ; clear any selection EXCLUDE ALL ; include all files with archive bit cleared INCLUDE BITS "a" =0 ; exclude all ".o" files EXCLUDE NAME "#?.o" == Note that empty lines and lines starting by a ";" character are ignored. Also note that ABackup stores automatically the recursivity indicator state at the beginning of your selection record : if you take a look at the created files you'll see they all beging by a "RECURS" command. If you want to be sure to clear a previous selection, it's recommended to start all your selections by clicking on the "ROOT" gadget and then on "EXCLUDE ALL". Usage_without_interface ABackup can be used from CLI, without it's graphic interface. This may be useful for doing automatical backup, with programs like "cron". Four operations are allowed from this level: backup, restore, rebuild catalogue, archive listing. Backup is started with a command like: ABackup BACKUP FROM dir TO arc SELECT {ALL|ARC|file} [OPTIONS {C|V|A|L}] [NOCOMP ext,ext,...] [VERBOSE] [REPORT file] [BUFSIZE size] [NOTASK] [TMPDIR dir] where "dir" is the directory to backup and "arc" the name of the archive to create. The "SELECT" argument allows to select files to backup: it must be followed by the name of a selection file (for exemple "ABCK:FullBackup"), by the keyword "ALL" which allow to select all files, or by the keyword "ARC" which allow to select all files with archive bit cleared. The "OPTIONS" optional argument allow to change backup options (CAUTION: by default, ALL options are reset) : "C" for compression, "V" for verifying, "A" to set archive bit, "L" to backup links. You can specify several options (for exemple "OPTIONS CV"). The "REPORT" optional argument allow to have a backup report. Specify "PRT:" as a file name in order to have this report printed. The "VERBOSE" optional argument allow to have more messages during backup. The other arguments are described at the "Getting_started" section. Restore is started with a command like: ABackup RESTORE FROM arc [TO dir] SELECT {ALL|file} [OPTIONS {F|D|E|L}] [REPLACE {YES|ASK|OLDER}] [VERBOSE] [REPORT file] [BUFSIZE size] [NOTASK] [TMPDIR dir] where "arc" is the name of the archive. The "SELECT" argument allows to select files to restore: it must be followed by the name of a selection file (for exemple "ABCK:SourcesFiles") or by the keyword "ALL", which allow to select all files without having to create a selection file. The "TO dir" optional argument allow to restore files in the specified directory, rather than the directory they were at backup time. The "OPTIONS" optional argument allow to change restore options (CAUTION: by default, ALL options are reset) : "F" to restore all files in the same directory, "D" to restore date, "E" to restore empty directories, "L" to restore links. You can specify several options (for exemple "OPTIONS FE"). The "REPLACE" optional argument allow to specify what ABackup has to do if a file to restore already exists. It must be followed by "YES" (or "Y", the file is replaced), by "ASK" (or "A", you will be asked for confirmation), or by "OLDER" (or "O", the file is replaced only if it's older than the one in the archive). By default, files are not replaced. The "REPORT" optional argument allow to have a restoration report. Specify "PRT:" as a file name in order to have this report printed. The "VERBOSE" optional argument allow to have more messages during restore. The other arguments are described at the "Getting_started" section. Rebuilding catalogue is started with a command like: ABackup REBUILD FROM arc [VERBOSE] [BUFSIZE size] [NOTASK] [TMPDIR dir] where "arc" is the name of the archive. The "VERBOSE" optional argument allow to have more messages during processing. The other arguments are described at the "Getting_started" section. Archive listing is started with a command like: ABackup LIST FROM arc [TO file] [NOTASK] [TMPDIR dir] where "arc" is the name of the archive. The "TO file" optional argument allow to write the listing into the specified file, rather than the console window. Specify "PRT:" as a file name in order to have the list printed. The other arguments are described at the "Getting_started" section. Program_history ABackup was written almost in C language, on an Amiga 3000 UNIX-1 (10 Mb RAM, internal HD disk drive, internal hard disk of 100 Mb, external SyQuest drive of 88 Mb, external floppy disk drive, 1960 monitor and Star LC24-10 printer) connected by a null-modem cable to an A500 with 1 Mb RAM. v1.00 08-Jun-92, 58036 bytes v1.10 20-Jun-92, 59404 bytes o Handles High Density floppy disks (1.76 Mb). o When run from the Workbench, you can change the size of the read buffer with "BUFSIZE=<size in Kb>" in the "TOOL TYPES" field of ABackup icon. o Several changes in backup : - when there is any problem at initialization time, goes back to the selection screen - when an archive file exists, or there is already a disk in drive, asks to confirm before starting writing - tests if files to back up are protected against a read (opening a file works in any case, but under 2.0 system release you will be kicked out at the first read operation) - displays the compression rate for every file (after "OK") o Several changes in the interface : - added the "Size" menu in the selection screen (Bytes/Kb/Mb) - displays backed-up/restored percentage and remaining one - the "monitor" window (in blue) is larger when screen is in PAL mode o Time valuation more accurate (uses the "timer.device"). v1.20 28-Jun-92, 62616 bytes o Added the "Selection" menu in the selection screen : you can record a selection and recall it later. o Fixed several bugs : - as a result of an error in the computing of remaining place in the last disk, sometimes it wrote a catalogue overlapping two different floppies - when you swapped a disk during a file header writing, it forgot to set up the disk position at 0 (in the catalogue) - during a read, at the end of a disk, it detected one byte earlier it had to ask for the next disk. o For a by date selection, you can give the month name (e.g. "01-Jan-92") o When run from the Workbench, it does not open the small "console" window. v1.30 01-Jul-92, 67640 bytes o Double-click upon a name starts a "view" operation o Under 2.0 system release, uses "dos.library" pattern matching functions (more powerful than SAS/C ones) o Added "Estimation" option in "Backup" menu o Displays error messages rather than error codes o Bug fixed in "draggin select": didn't displayed directories when scrolling list o Restore screen's title when "Abort" is selected on archive selection menu (Restore) v1.31 04-Jul-92, 68316 bytes (Fish #706) o Added "Restore date" option o Added auditive beep in alert/wait functions o No more need for "arp.library" to make drives "BUSY" under 1.3 system release o Estimations more accurate (don't suppose that last disk is full) v1.40 22-Aug-92, 78328 bytes o Can use several disk drives for backup o Full access from CLI ("batch" mode) o Bug fixed: always tried to decompress archive catalogue (even if it was not) o Bug fixed: when loading archive file catalogue, scanned all archive beginning (instead of going straight to the good location) o Preparation of non-dos partitions backup (most of the required code written) o Added visual beep to each auditive beep v1.50 09-Sep-92, 81068 bytes o Added support for links under 2.0 system release (both hard and soft links are handled) o Added "Backup links" and "Restore links" options o Added "Automatic" item to "Size" menu o Added "NOCOMP ext,ext,..." argument o When requesting a disk for writing, verifies that the disk has really been changed before continuing o If an error occurs while writing on a disk, make one retry o Error in percentage computation corrected o On selection screen, directories with at list one child selected are displayed on a black background o No more overflow from "monitor" window if file name is too long o Bug fixed in SendPacket() function o Bug fixed in time computation (00:29:59 + 1 gave 01:00:00 ... whoops !) o Forgotten trace message removed v1.51 07-Oct-92, 81048 bytes o Any file or directory whose comment begins with "SKIPME" is ignored when loading directory tree o Bug fixed : no more problems if the size of a file change between the time we load directory tree and time we save the file o Bug fixed : didn't clear destination name between two restore (so the second was made is the same directory than the first) o Update status display when disk is changed v1.60 15-Oct-92, 84312 bytes (Fish #759) o Added function to rebuild catalogue o Selection screen modified (added "OPTIONS" and "START" gadgets, etc...) o Estimations for 68000 Amigas corrected (thanks to JYP !) o If a file is read protected (under 2.0 system release) ask for retry o When restoring, display the name of the file created instead of the name in the archive o Restore option "At the same level" renamed "Restore dir. tree" v1.61 21-Oct-92, 84472 bytes o From WB may be set as "DEFAULT TOOL" of an archive file o File type (for visualisation) : no longer binary when an <ESC> character is found o Window are now centered on the screen o Menus are no longer present during backup or restore v1.70 29-Oct-92, 87016 bytes o Can use external programs for compression/decompression o Added a menu for the startup screen (Config, About, Quit) o Screen's title show what is the current operation o On selection screen, when restoring, the "Directory" field shows the destination directory o By default, compression is disabled o Documentation modified so it can be read with ADoc v1.80 11-Nov-92, 88528 bytes o Creates a child task for disk write operations (speedup backup between 10-20%) o Sets archive bit only on files/dirs which have not it already set o Filenames are truncated to the left instead of the right ("Directory" field, "monitor" window, e.g. ".../foo/bar") v2.00 22-Nov-92, 90492 bytes (Fish #780) o Can use XPK library o Added the error recovering function v2.01 06-Dec-92, 90520 bytes o When using XPK compression, sometimes forgot to delete a temporary file o Disable compression if preferences tells to use XPK and library couldn't be opened o Cosmetics changes on file requester v2.10 12-Dec-92, 88652 bytes o Compiled with SAS/C 6.00 o New catalogue format, far more compact o Show catalogue size when adding it to archive o A few optimizations in display functions (gadget borders now draw with GfxGList instead of GfxOp) o The "Parent" gadget at the left of the file list has now a border v2.11 19-Dec-92, 88708 bytes o When writing catalogue, display the informations as when writing a file (Crunching, Writing, Ok x%) o Updating informations when disk changed : now only disk number and time modified v2.12 25-Dec-92, 89492 bytes o Compiled with SAS/C 6.1 o Verifies XPK.library version (at least version 2) o Added argument TMPDIR to change temporary directory v2.13 08-Jan-93, 90208 bytes o Child task disabled under system release 3.0, because it makes the system crash. o When modifying backup options, compression methods cycle in reverse order if SHIFT key is hold down. o When backing up to a file, the gauge displays the filling percentage of the volume. o Bug fixed: in "batch" mode, forgotted the target directory specified for restoration. v2.20 16-Jan-93, 90644 bytes o Can now restore from several disk drives o Bug fixed in backup: saved the target name instead of the link name (though didn't found the link at restore time) o Bug fixed in backup: the AddCatalog() function didn't returned the correct return code if the catalogue wasn't compressed o Bug fixed in restore: didn't restore the correct date for directories o Bug fixed in reports: didn't write the correct date for directories o The call of viewer programs is safer v2.30 24-Jan-93, 91700 bytes o Can now save several partitions in the same archive o Bug fixed when writing configuration file: the viewer program names were not written at the good position o The temporary directory can be modified in the configuration window, and saved in the configuration file. o Added the "SIZE" argument (changes default value of "Size" menu) o Communication with child task now performed via messages (instead of signals) o Child task stack size is now 4Kb (instead of 2Kb) o Shortening names too long: now tries to remove a full directory name until it works, also done when writing reports. o Bug fixed in date computation. o Since v2.20, viewing a file didn't worked if the viewer program detached itself. o Final requester of non-registered version more irritating o A few optimizations in display functions v2.31 30-Jan-93, 91888 bytes o If a SHIFT key is hold down while you click upon a directory name, the whole directory content is selected/deselected o Drag selecting now also include/exclude directories o Bug fixed: sometimes losed archive name before starting restore v2.40 06-Feb-92, 92364 bytes o No more crashes with child task under OS 3.0 (KS 39.106, WB 39.29) o Recompiled with SAS/C 6.2 o Link restoration more efficient (no need to insert disks twice) o Directory sort faster (QuickSort instead of Shell sort) o Enhanced multi-selection in file requester v2.41 20-Feb-93, 93124 bytes o Can now use the file requester from asl.library (USEASL argument) o Recognize now XPK and PowerPacker compressed data files and don't compress them o Add a comment to archive files saying they are ABackup archive files v2.42 23-Feb-93, 93264 bytes o Bug fixed: when using external compression, ABackup tried to restore protection bits and date on the temporary file (which was already deleted) instead of the restored file. o Bug fixed: for Lock() to work on a soft-link, you must be in the directory were is the link, so now temporary changes of directory. o Bug fixed in french version: if an error occured when setting archive bit, the error message was not good o Bug fixed in english version: didn't display catalogue size at the end of the backup Planned improvements : o Support for non-AmigaDOS partitions (AMAX, etc...)